很多人在用 ComfyUI 时纠结要不要更新：新版本新增节点、修复显存 bug、支持新模型，但乱更新又容易出现节点报错、工作流崩溃。本文整理目前主流三种安装方式的标准更新流程，附避坑要点与故障解决方案。
⚠️ 更新前必看（重中之重）
- 先完全关闭 ComfyUI，后台命令行窗口全部退出，不要热更新。
- 建议备份
- 重要生产环境：直接复制整个
ComfyUI_windows_portable文件夹做完整备份； - 简易备份：至少备份
custom_nodes（自定义节点）、你的工作流 JSON 文件。
- 重要生产环境：直接复制整个
- 分清版本区别
- 稳定版 stable：bug 更少，日常生产优先选择；
- 开发版 nightly（main 主线）：最新功能，可能存在兼容性问题，适合尝鲜。
- 谨慎使用一键重装依赖脚本，极易造成第三方节点环境冲突。
一、Windows 官方便携版（绝大多数新手在用）
目录结构：ComfyUI_windows_portable/
进入文件夹内 update 目录，里面 3 个脚本，按需选择：
- update_comfyui_stable.bat【推荐日常更新】 更新官方稳定发行版，风险最低，适合长期跑图、商用工作流。
- update_comfyui.bat 拉取 GitHub 主线最新开发版，抢先体验新功能。
- update_comfyui_and_python_dependencies.bat【慎用！】 不仅更新本体，还会重装全部 Python 依赖、升级 PyTorch。 ✅ 使用场景：环境严重损坏、大量包缺失报错 ❌ 风险：大概率导致部分自定义节点失效、CUDA 版本不匹配。
操作步骤
- 关闭所有 ComfyUI 窗口；
- 双击对应
.bat脚本； - 等待命令执行完毕，出现「按任意键退出」代表更新完成；
- 启动 ComfyUI，测试基础文生图工作流确认正常。
网络较差、GitHub 连接超时：多运行 2～3 次脚本；条件允许配置网络代理。
二、Git 手动安装版（Mac/Linux、自行搭建虚拟环境用户）
适合 conda、venv 自建环境，不使用官方便携包。
打开终端 / CMD，进入 ComfyUI 主目录执行：
bash
# 1.拉取最新代码
git pull --ff-only
# 2.更新官方依赖（每次更新建议执行）
pip install -r requirements.txt
如果你想切换稳定版，需要手动切换对应 tag，不熟悉命令行优先使用开发主线。
Mac / Linux 简易一键命令
bash
cd ~/ComfyUI
git pull --ff-only
pip install -r requirements.txt
三、Comfy Desktop 官方桌面版
独立客户端，和便携版互不通用：
- 打开 Comfy Desktop；
- 左上角菜单打开
Desktop Settings； - 切换到 Updates 标签页；
Check for updates检测新版本，点击Restart & Update；
Desktop 客户端更新 ≠ ComfyUI 内核更新，在内置实例面板可以单独升级 ComfyUI 引擎。
Desktop设置入口
更新面板
四、自定义节点怎么同步更新（ComfyUI Manager）
更新本体之后，第三方节点也建议同步维护：
Manager更新面板
- 打开 ComfyUI 网页界面，启动 Manager；
- 点击
Install Custom Nodes→ 切换到 Updates； - 批量勾选可更新节点，点击 Update；
- 更新完成必须重启 ComfyUI生效。
小提示：
Update All仅更新自定义节点，不能更新 ComfyUI 本体，很多新手在这里踩坑。
五、更新后常见报错与解决方案
1. git pull 冲突 error: merge conflict
原因：手动修改过 ComfyUI 源码文件
bash
# 先临时保存本地改动
git stash
git pull --ff-only
# 需要恢复修改再执行
git stash pop
如果你不懂代码修改，最简单方案：备份 custom_nodes，重新下载纯净 ComfyUI 本体覆盖。
2. 更新启动后大量红色失效节点
- 使用 Manager 更新全部自定义节点；
- 部分节点不再兼容新版 ComfyUI，需要寻找替代节点；
- 最坏情况：回滚到更新前备份的文件夹。
3. 前端界面异常、缺少新功能按钮
只执行了 git pull，没有运行 pip install -r requirements.txt，前端包未同步更新，补执行依赖安装即可。
4. 更新脚本一直卡住、超时失败
GitHub 访问不稳定，重复运行脚本；不要频繁强制关闭命令窗口，容易造成文件损坏。
六、更新策略建议（最佳实践）
✅ 稳定生产机器：每月更新一次稳定版，更新前完整备份；
✅ 尝鲜测试机器：使用开发版，遇到 bug 随时回滚；
✅ 不要每次出新 commit 就立刻更新，避开刚发布的重大版本前 3 天；
✅ 重大版本升级（如底层架构、前端重构），务必先用副本测试工作流。
补充：如何查看当前 ComfyUI 版本
打开网页端 → 设置（⚙️图标）→ 拉到最下方【关于】，可以看到当前版本号与提交时间。
